home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d1
/
findf11.arc
/
FINDF.DOC
next >
Wrap
Text File
|
1989-12-25
|
33KB
|
986 lines
FINDF
File Finder utility
Version 1.1
Released 12-10-89
Herron Software
P.O. Box 1288
Battle Ground, Washington 98604
COPYRIGHT 1988, 1989 Phil Herron. ALL RIGHTS RESERVED.
DISCLAIMER OF WARRANTY
__________________________________________
THIS PRODUCT IS PROVIDED FOR EVALUATION, AS IS
AND WITHOUT WARRANTY OF ANY KIND. THE AUTHOR
MAKES NO EXPRESS OR IMPLIED WARRANTIES,
INCLUDING BUT NOT LIMITED TO MERCHANTABILITY
OR FITNESS FOR ANY PURPOSE. IN NO EVENT SHALL
THE AUTHOR BE LIABLE FOR LOSS OF PROFIT OR ANY
OTHER COMMERCIAL DAMAGE ARISING FROM EITHER
THE USE OF OR THE INABILITY TO USE THIS PRODUCT.
This product should be thoroughly evaluated
using backed up or noncritical data and files.
______________________________________________________________
Evaluation Preface Section
______________________________________________________________
Shareware............................................... 0.1.0
What it is............................................ 0.1.1
License Terms......................................... 0.1.2
Registration.......................................... 0.1.3
Benefits, Forms, Registration fees,
Quantity discounts, Combined orders
Evaluation.............................................. 0.2.0
Evaluation Version.................................... 0.2.1
Evaluation Menu....................................... 0.2.2
Virus Prevention...................................... 0.2.3
_____________________________
0.1.0 Shareware
_____________________________
0.1.1 The SHAREWARE Concept
_____________________________
"Shareware" is a software distribution method which enables
the potential user to obtain software at very low initial
cost, for evaluation on a trial basis.
You can evaluate the software in your own environment, on your
own machine, with the programs and data that you normally use.
You're not required to become a registered user unless the
software meets your needs.
Another benefit of Shareware is lower pricing. By minimizing
the marketing and advertising expenses associated with more
traditional software distribution methods, Shareware products
can be priced lower. You don't pay for what you don't need or
use.
You are encouraged to share the evaluation version of this
software with others, so long as you follow the limitations
set forth in the LICENSE TERMS section below.
0.1.2 LICENSE TERMS
_____________________
This product and its documentation are copyrighted and owned
solely by the author, who reserves all rights to any benefits
derived from it. It is distinctly separate from, and should
not be confused with, those categories of software known as
"public domain" or "freeware."
You are granted the right to use the evaluation version of
this software on a trial basis for a limited amount of time,
to decide whether to continue using (and therefore whether
to register) the product.
You can transmit this evaluation version to associates by
copying on diskette or uploading to electronic bulletin board
services, so long as the following CONDITIONS are met:
(a) The program and its documentation file must be
distributed together.
(b) The program and its documentation must not be
altered in any way. If you wish to include
notes for other evaluators, please add them in
a separate file and include that file along
with the program and documentation files.
0.1.3 REGISTRATION
____________________
When you send in the registration form and fee, you'll
receive by return mail a diskette containing the latest
REGISTERED version of the program and documentation.
BENEFITS OF REGISTRATION
The registered version WILL NOT include the Evaluation Menu
front-end, startup time-delay or forms-printing sections of
this version. Thus it will be more convenient to use, from
either the DOS prompt or from batch files. It will also be
12k-15K bytes smaller, for more efficient disk storage and
faster loading.
The registered version WILL include any new functions
or enhancements made to date.
You will receive notification of future updates and
new products.
You will be able to upgrade to newer versions at a
reduced cost.
REGISTRATION FORM
The registration form and a pre-addressed mailing cover
can be printed from the "Forms Printing" selection of
the Evaluation menu, discussed in section 0.2.2 below.
FEES
The single-quantity registration fee is displayed on the
initial Evaluation Menu screen. Higher quantities are
discussed below.
QUANTITY DISCOUNTS
Each registered copy of this software will be licensed for
operation at a single location (on a single terminal or
computer) at any one time. If you need to run the software
on more than one terminal or computer at the same time, the
appropriate number of registrations must be made.
Multiple-quantity registration fees are displayed in the
"QUANTITY DISCOUNT" section of the Evaluation menu.
You can take advantage of quantity discounts by ordering
multiple registrations of one program or single
registrations of several different programs at the same
time. You also save on shipping and handling charges
by registering several products together.
COMBINED ORDERS
You can also take advantage of quantity discounts by
combining orders with associates:
(1) Complete a separate registration form for each person.
Each person's name, address and programs to be
registered are needed for support and update
notification purposes.
(2) Include only one standard shipping and handling charge.
Cross out the "Shipping & handling" amounts on
all but ONE registration form; the combined
order will be sent to the name and address on
that form.
(3) Mail all the forms together, with a single check/money
order for the total, in one envelope/mailing cover.
_____________________________
0.2.0 Evaluation
_____________________________
0.2.1 EVALUATION VERSION
__________________________
This software contains the complete and fully functional version
of the program, the latest available at the time of this release.
The program itself is identical to the REGISTERED version.
An Evaluation Menu and forms-printing section were added
to ensure that:
(a) Registration information and forms will not
become separated from the program file.
(b) Users who might be unfamiliar with the process
of displaying a file's contents on the screen or
printer will have no difficulty learning about,
evaluating or registering this product.
0.2.2 EVALUATION MENU
_______________________
The program is invoked from the DOS prompt by typing its name
and pressing the RETURN or ENTER key.
The initial screen displays the warranty section and some
information about the program:
Program name,
Version number,
Release date,
Single-quantity registration fee.
It next displays the Shareware Product EVALUATION MENU.
A single key press will select the following functions
from the menu:
ESC - EXIT to DOS without evaluating this program
R - READ the documentation (THIS file)
x - EVALUATE this program
Q - QUANTITY Discount information
F - FORMS printing menu - registration & mailer
When you press "R" to READ the documentation, this file will
be shown one screen at a time. The display pauses whenever the
screen becomes full, and prompts...
<downArrow> or Esc
The <downArrow> character is similar to the "MORE" prompt in
other DOS utilities. It indicates that more is available.
Press ESCape to exit back to the Evaluation Menu, or any normal
typing key to continue (space bar is a convenient key to use).
0.2.3 VIRUS PREVENTION
________________________
If you'd like to evaluate this software but you're not sure
where it's been, you can order a copy straight from the source.
See the SHAREWARE PRODUCT CATALOG section at the end of this file.
_________________________________________________________________
Table of Contents Section
_________________________________________________________________
FindF...................................................... 1.0
Introduction............................................ 1.1
Explanation............................................. 1.2
System Requirements..................................... 1.3
Installing........................................... 1.3.1
Help.................................................... 1.4
Syntax.................................................. 1.5
Wildcard Characters.................................. 1.5.1
Examples................................................ 1.6
Operating screen..................................... 1.6.1
Operating screen with output REDIRECTION............. 1.6.2
File Attributes......................................... 1.7
DOS ErrorLevel.......................................... 1.8
Application: File listing............................... 1.9
Application: File locating across multiple drives....... 2.0
Version History......................................... 4.0
Support.................................................... 9.0
Problem Resolution...................................... 9.1
Before Reporting........................................ 9.2
Reporting a problem..................................... 9.3
Custom Modifications.................................... 9.4
Correspondence.......................................... 9.5
Shareware Product Catalog................................. 10.0
******************************************
NEW in this version
******************************************
* Nested Subdirectories *
FINDF can now search subdirectories nested
up to sixteen levels deep, just in case
anyone uses that many levels.
* Color Support *
Previous versions employed white text on
black background exclusively; this version
uses the default colors in effect when
the program is started.
______________________________________________________________
FINDF
1.0
File Finder utility
______________________________________________________________
1.1 INTRODUCTION
__________________
With the growing storage capacities of modern disk drives,
you can keep more and more files online, in more and more
subdirectories. With so much space available, files can
be misplaced more efficiently than ever before.
If your hard disk is so large that you can't keep track of
which files are in which subdirectories, and you can't locate
files when you need them, you need help.
1.2 EXPLANATION
_________________
FindF can find those misplaced files, as long as they've been
misplaced on your default drive. If they're misplaced on a
diskette in a box in the back room, you're on your own.
FindF's output can be redirected to a file, in case you want
to keep a list of the files that get lost most often. Then
again, THAT file may get misplaced. Use FindF to add it
to the list.
1.3 SYSTEM REQUIREMENTS
___________________________
PC, XT, AT or compatible.
DOS version 2.1 or later.
64K free memory.
1.3.1 INSTALLING
__________________
The program can be run from diskette or from hard disk.
No installation is necessary, other than copying the
files to a drive and directory of your choosing.
1.4 HELP
__________
Can't remember the command line syntax?
Issue the program's name without any parameters; it
will display a help screen, then return to the DOS prompt.
1.5 SYNTAX
____________
Short display format
/
FindF [filename.ext] [/S]
where...
Default display format is
FINDF .EXE 15515 04-16-89 23:59
Short display format is
FINDF .EXE
1.5.1 WILDCARD CHARACTERS
___________________________
Wildcard characters * and ? are legal for use in specifying
filenames and extensions.
1.6 EXAMPLES
______________
FindF *.bat Finds all files with extension
.BAT anywhere on the current
drive. Displays on screen.
FindF *.bat >BatFiles.Lst Same as above, but sends list
to file named BatFile.Lst
FindF *.bat /s Short display format to screen.
FindF *.bat /s >BatFiles.Lst Short display format to file
named BatFile.Lst.
1.6.1 OPERATING SCREEN
________________________
The operating screen appears whenever "FINDF" is issued from the
DOS prompt with a filename; in this example, the complete
command line is:
FindF *.bat
and the screen displays:
__FindF_______________________
|______________________________|
Find *.BAT on drive C: Thu 23 Mar 1989 6:49:50 PM
The screen displays nothing more until a file is found that
matches the input file specification. The search can be
exited at any time by pressing the ESCAPE key.
Upon finding a match, the drive, path and file information
are displayed:
C:\(ROOT directory)
AUTOEXEC.BAT 27 01-28-89 14:17
The display pauses whenever the screen becomes full, and
prompts...
ESC-exit <downArrow>-more
The <downArrow> character is similar to the "MORE" prompt
in other DOS utilities. It indicates that more is available.
Press ESCape to exit to DOS, or any normal typing key to
continue.
If not exited early, the search continues until all
subdirectories on the drive have been checked and no more
matching files are found.
A SUMMARY line then reports the number of files found, and the
number of directories in which they were found. If you pressed
the ESCAPE key at any point during the run, the summary section
also displays
"Early termination"
to indicate that the files shown on screen or in the redirected
file may not be a complete list. If the output was redirected to
a file, this summary section is also written to that file, rather
than to the screen.
1.6.2 OPERATING SCREEN with output REDIRECTION
________________________________________________
FINDF's output can be redirected to a file by using the DOS
redirection characters > or >>...
> Sends output to specified file; overwrites the file
if it already exists.
>> Appends output to the end of the specified file.
You could use each in turn to generate a file containing a list
of all the executable files on your default drive:
FindF *.Com > RunFiles.Lst
FindF *.Exe >>RunFiles.Lst
During redirected operation, the screen displays only the
standard header and, at the bottom, the ESCape prompt:
__FindF_______________________
|______________________________|
ESC-exit
1.7 FILE ATTRIBUTES
_____________________
FindF will find all files with Ordinary, Archive, ReadOnly,
Hidden and System attributes.
Files with Directory or Volume label attributes are ignored.
1.8 DOS ERRORLEVEL
____________________
Upon termination, the program returns a DOS ErrorLevel value
which indicates how the program ended, and which can be used for
subsequent operations in a batch file. For further information,
see the "IF ERRORLEVEL" batch command in your DOS manual.
ErrorLevel List:
0 - Successful completion.
1 - No parameters specified on command line.
27 - Early termination; ESCape key pressed.
Example of ErrorLevel usage in a batch file:
FINDF *.bak
if errorlevel 1 goto END
:EL0
.
.
:END
If FindF terminates normally with an errorlevel of 0, then
the section following the label :EL0 will run. However, if it
returns an errorlevel of 1 OR GREATER (most likely caused by the
user pressing the ESC key to terminate early), then the :EL0
section will be skipped.
For a working example, see the batch file in the second
following application section.
1.9 APPLICATION: file listing
_______________________________
ListAll.Bat can be used to generate a listing of all files and
subdirectories on the default drive.
To maintain an overview of your hard disk's contents and
directory structure in case of drive problems, run ListAll
periodically and save the output on a backup diskette.
Command-line syntax:
ListAll [outputFileSpec]
Usage:
ListAll A:allFiles.Lst
will write all information to a file named
AllFiles.Lst on drive A.
Listing:
:::: ListAll.Bat - file & subdirectory listing utility
echo off
If "%1"=="" goto NoSpec
echo Writing Tree diagram & Directory to %1 - Standby . . .
echo ---------- Tree Diagram & Directory ---------- >%1
Vol >>%1
echo . >>%1
:::: next line: use Ptree.Com, Vtree.Com, or comment out with colons
Ptree >>%1
echo . >>%1
FindF *.* >>%1
echo ----- %1 Completed -----
goto END
:NoSpec
echo Syntax: %0 [outputFileSpec]
echo Writes tree-structure diagram and complete directory of default
echo drive to specified file. Uses FindF & Ptree/Vtree utilities.
:END
Notes:
1 - There are several ways to convert the above listing
into batch file form. One is to copy this entire file to
another named "ListAll.Bat", delete everything except the
listing, then delete the leading spaces on the left side so
each line begins in column one. Another is to display the
listing on screen, then use a memory-resident notepad to
"cut and paste" it into a batch file.
2 - Single colons in the listing mark labels needed for
proper operation. Multiple colons denote non-operational
comment lines.
3 - Several statements in the batch file listing are
intended to insert a blank line into the output file:
echo . >>%1
A dot is used here for ease of converting the listing
text into batch file form. Once the listing is in a
batch file, each occurrence of the dot can be replaced by
a blank character, ASCII 255 decimal. This character is
entered by holding down the <alt> key and entering the
decimal number 255 on the numeric key pad.
4 - Vtree.Com is a PC Magazine utility. Ptree.Com is a
version of Vtree.Com that uses only standard ASCII
characters, for ease of printing.
2.0 APPLICATION: File locating across multiple drives
_______________________________________________________
FindAll.Bat can be used to locate files on multiple drives.
Command-line syntax:
FindAll [filename.ext]
Usage:
FindAll *.Doc
will locate all .DOC files on drives A, B and C.
Listing:
:::: FindAll.Bat -- handles drives A,B,C as written.
echo off
if "%1"=="" goto NoSpec
A:
FINDF %1
pause
if errorlevel 1 goto END
B:
FINDF %1
pause
if errorlevel 1 goto END
C:
FINDF %1
goto END
:NoSpec
echo Syntax: %0 [filename.ext] - wildcards * and ? are legal
echo File finder for drives A, B and C
:END
C:
4.0 VERSION HISTORY
_____________________
1.00 Initial release.
1.07 Display is no longer fixed white on black, but now uses
the default colors in effect when the program is started.
1.1 Coverage of nested subdirectories has been extended
to a depth of sixteen.
_________________________________________________________________
9.0 Support
_________________________________________________________________
9.1 PROBLEM RESOLUTION
________________________
Please document and report any anomaly in program operation,
whether it's a genuine "bug" or just some feature of the
program that particularly "bugs" you.
If you're the first person to document and report a problem
that we agree needs attention, you'll receive a free upgrade
with the correction when it's been made. If you're a
registered user, you'll get the upgraded registered version;
if you haven't yet registered, you'll get the upgraded
evaluation version.
9.2 BEFORE REPORTING
______________________
Things to try prior to reporting a problem:
1 - Reread the documentation to make sure you understand
what we thought we understood when we wrote it.
2 - If the system reports "Bad command or file name" when
you attempt to run the program, its executable file
(or at least the file name you specified) was not found.
First, make sure no typos or misspellings have crept
into your command line; next, try changing your PATH
setting, or make the drive & directory where the program
resides the "current" drive & directory.
3 - If the program is being run from a batch file, try
deleting lines previous to the line that actually
invokes the program, to see if some prior activity
is causing the problem.
4 - If you have any memory-resident or "TSR" utilities
installed (pop-up calculators/note pads, keyboard
enhancements, etc.), try removing them from memory
and running the program again to see if the problem
reoccurs.
9.3 REPORTING A PROBLEM
_________________________
If the problem persists, please document it as completely and
accurately as possible; we have to be able to duplicate it
before we can begin to resolve it.
Include at least the following:
1 - Version of DOS you are using.
2 - Machine type, drives, memory, etc.
3 - Programs executed prior to the problem.
4 - Problem program's name and version number.
5 - Where and how you obtained the problem program.
6 - Address and/or phone number where you can be contacted.
7 - Anything you can think of that might relate to the problem;
for example, listings of your AUTOEXEC.BAT and CONFIG.SYS
files, or any batch files used to run the program.
8 - Any relevant printouts.
NOTE: If you're a registered user, you'll find the utility
UserResp.Exe on the distribution diskette; it can be used
to print a pre-addressed mailer and a problem report.
If you have not yet registered, send problem reports to the
address below (or print the pre-addressed mailer from the
Evaluation Menu).
9.4 CUSTOM MODIFICATIONS
__________________________
If you need custom modifications to this software for your
particular application, please write to the below address
with complete details of your requirements.
9.5 CORRESPONDENCE
____________________
We welcome any comments or suggestions you might have
concerning improvements and future enhancements to this
product. Send all correspondence and orders to:
Phil Herron
P.O. Box 1288
Battle Ground, Washington USA 98604
_________________________________________________________________
10.0 Shareware Product Catalog
_________________________________________________________________
This section contains a list of our other Shareware products;
it may be updated whenever products are added or changed.
____________________________________________
If you'd like to try any of the programs in this catalog, but
can't find them locally, you can order evaluation copies
straight from the source...
Five programs and their associated documentation will fit on each
5.25 inch 362Kb diskette; the basic single-disk fee of $4.00
covers the cost of the first disk, shipping and handling. Add an
additional dollar for each additional disk of programs you want to
evaluate ($4.00 for 1 to 5 programs, $5.00 for 6-10, $6.00 for
11-15, etc.; all payments in U.S. funds). If your address is
outside the U.S. and Canada, add an additional $3.00.
Include your mailing address and the names of the programs. By
return mail you'll receive the latest versions of those programs
for evaluation.
____________________________________________
"Shareware" is a software distribution method which enables the
potential user to obtain software at very low initial cost, for
evaluation on a trial basis. You can evaluate the software in your
own environment, on your own machine, with the programs and data
that you normally use. You're not required to become a registered
user unless the software meets your needs.
____________________________________________
PROGRAM SPECIFICATIONS AND REGISTRATION FEES
MAY CHANGE WITHOUT NOTICE.
____________________________________________
ChkD v1.1
Check_Disk_space reports disk drive space usage. It reports drive
cluster size, then drive space TOTAL, FREE and USED by actual value
and by percentage. It is faster and more convenient than the DOS
"dir" or "chkdsk" utilities for displaying drive information.
ChkM v1.1
Check_Memory_space reports standard system memory (RAM) space usage.
It reports memory space TOTAL, FREE and USED by actual value and by
percentage. It is faster and more convenient than the DOS "chkdsk"
utility for displaying system memory information.
CleanOut v1.3
CLEANOUT searches all directories of the default drive for file(s)
specified on command line (wildcards * and ? are legal). Each time
a matching file is found, the user is prompted for disposition:
Delete or Save. File contents, either text or binary, can be VIEWED
before deciding. A single press of the "S" key saves a file; a
double press of the "D" key deletes it. An optional mode allows
deletions without confirmation. Useful for cleaning out .BAK file
leftovers, among others.
CleanTxt v1.1
CleanTxt converts WordStar text files to straight ASCII. It strips
out certain control characters, and will optionally expand tab
characters to the appropriate number of spaces.
CleanZ v1.2
Most text editors won't read files beyond the first control-Z end-
of-file character. Control-Z's can become embedded in a text file
when several files are combined using the DOS "type" command.
CleanZ will strip out each control-Z, or it will optionally replace
each with a seldom-used character, to ease the task of locating the
former boundaries in combined files.
FindF v1.1
FindFile searches the default drive for specified files, and writes
the file information to screen or disk. Useful for locating
misplaced files or for generating a listing of all files and
subdirectories on the default drive.
Gen v1.2
Gen replaces several trial-and-error methods of building specific-
sized files for printer, storage or timing tests. It generates
files of any size from zero to twenty million bytes, much faster
than typing random characters into a text editor. Besides
generating files on disk, it can send a specific number of
characters directly to the console screen, printer or
other DOS device.
KeyCode v1.1
KeyCode responds to each press of a key or combination of keys by
displaying the key or combination pressed, its associated Ascii
character (if any), key type (normal or extended), Ascii code and
Scan code.
KeySet v1.1
KeySet's interactive mode displays the current settings of the
CapsLock, NumLock, ScrollLock and PrtSc (Print Screen) keys, and
allows them to be changed. The command line mode directly sets the
keys to specified states, allowing use of a batch file for
presetting at system bootup or between applications.
PrinTest v1.2
PrinTest repetitively displays the status of ports assigned to
parallel printer interfaces. It can be used to isolate problems to
the printer interface card, the cable or the printer itself. It
reports printer and port number, status byte and status condition.
Qscr v1.2
QuickScreen converts a single text screen to an executable file for
more rapid display. The resulting .COM file will write a screen of
text much faster than batch file ECHO statements. Useful for
setting up compact menu systems, demos and tutorials.
ScanF v1.1
Scan_File speeds up the search for ASCII text strings within
executable files. It filters out the unintelligible control and
extended characters, allows user definition of minimum string length
for display, and pauses after each screen of information.
ScanM v1.1
Scan_Memory speeds up the search for ASCII text such as ROM
copyright statements and machine identification, anywhere within
standard system memory space. It filters out the unintelligible
control and extended characters, displays each string longer than
three characters, and pauses after each screen of information.
Split v1.1
Split breaks huge text files down into smaller ones that will fit
into your text editor or onto a diskette. Useful for working on
large files with a limited-filesize memory-resident notepad utility.
StoRm v1.1
STOrage_RooM reports the amount of disk space required for storage
of a specified file or group of files on any disk, using any version
of DOS. It takes into account all of the factors involved in
determining file storage size. It locates files specified on the
command line and determines their actual total size and the amount
of room needed to store them. Useful for determining the number of
files that will fit on a disk.
PhLBL v0.75 (not yet released)
Label printer using text stored in ASCII files. Each label/card/
tag can contain embedded commands for date, time, series (nn OF nn),
consecutive serial numbering, left margin, and selectable printer
attribute for each line; 5, 10, 12, 17 or 20 characters per inch
pitch, normal/bold/underlined on Epson compatible dot-matrix
printers.
_______________________________________________________________
| |
| COPYRIGHT 1989 Phil Herron. ALL RIGHTS RESERVED. |
|_______________________________________________________________|